home *** CD-ROM | disk | FTP | other *** search
/ MacUser Mac Bin 40 / MACUSER-MACBIN40A-1997-03.ISO.7z / MACUSER-MACBIN40A-1997-03.ISO / 特集⁄オンラインソフト / ゲーム＆アミューズメント / アミューズメント / Citron 1.07J⁄E / 収録XCMD説明＆サンプルスタック / XCMD⁄XFCN説明書 / Jasmine説明書 < prev    next >
Text File  |  1996-11-12  |  10KB  |  169 lines
  1.   Jasmine XFCNは、HyperTalk上で文字列を扱う際に、おバカなHyperTalkの日本語インプリメントを回避して、確実に操作を行うことを目的としたXFCNです。
  2.   Jasmine XFCNを用いることで、バージョンや英語版／日本語版に関わらず、常に同じ文字列操作環境を得ることが可能です。
  3.   ※２バイト文字についてはシフトJISを想定していますので、他の２バイト文字コードでは不具合が出る可能性があります
  4.  
  5.   Jasmine XFCNは、落合  徹（ちゃい）が著作権を所有しています。自作のスタックなどに利用する場合は、当ドキュメントの「使用上の注意」の項を良く読んでからご使用ください。
  6.   なお、自作のスタック等にインストールする場合は、CitronをHomeスタックへインストールするか、ResEdit等のリソース関連ツールでJasmine XFCNをコピーしてください。
  7.  
  8. 【Jasmine XFCN】（Version 1.70      CodeWarrior Gold10使用 1996/11）
  9.  
  10. 0．更新履歴
  11. （Version 1.70      CodeWarrior Gold10使用 1996/11）
  12.   検索した結果が何行目に含まれているかを返す機能を追加
  13.  
  14. （Version 1.60      CodeWarrior Gold9使用 1996/6）
  15.   Power Macintoshネイティブのバージョンも新たに作成
  16.   Citron添付用に、名称を今までのJTextからJasmineに変更
  17.   一般初公開バージョン
  18.  
  19. （Version 1.58      CodeWarrior Gold7使用 1996/3作成）
  20.   日本語文字列検索ルーチンで、検索文字列に１バイトだけ設定した場合に、日本語処理が働かないというバグを修正
  21.  
  22. （Version 1.40      THINK C 7.0使用 1995/10作成）
  23.   文字数の異なる文字列の置換等、大幅に機能追加
  24.  
  25. （Version 1.00      THINK C 5.0.4使用 1994/6作成）
  26.   初回バージョン
  27.  
  28. 1．使い方
  29.  
  30.   以下に使い方を紹介します。
  31.  
  32.   Jasmineは以下の機能を持っています。
  33.  
  34.   ・１バイトコードの一括置換
  35.   ・文字列の置換
  36.   ・文字数を数える
  37.   ・文字列中から指定文字列を探し出し、その位置を返す
  38.   ・文字列中から指定文字列を探し出し、その行位置を返す
  39.   ・アルファベットを大文字／小文字に統一する
  40.   ・文字列中から指定範囲を抜き出す
  41.   ・２つの文字列の比較
  42.  
  43.   個別に解説します。
  44.  
  45. −１バイトコードの一括置換
  46. 【形式１】  Jasmine(TransCode,テキスト,変換前コード,変換後コード)
  47. 【形式２】  Jasmine(JTransCode,テキスト,変換前コード,変換後コード)
  48. 【解説】
  49.   テキストに与えた文字列中の、変換前コード（１バイトに限る）を全て変換後コード（１バイト）に置き換えます。それぞれのコードは、文字で与えてください。例えば、改行コードを与えるときはHyperTalk定数のreturnを、ベルコード（$07）を与えるときはnumToChar関数を用いて、numToChar(7)と言うように与えます。形式２の場合は、コードの検索に日本語文字区切りを用い、２バイトコード中の１バイトが変換前コードに合致しても無視します。
  50.  
  51. −文字列の置換
  52. 【形式１】Jasmine(Change,テキスト,検索文字列,置き換え文字列)
  53. 【形式２】Jasmine(Replace,テキスト,検索文字列,置き換え文字列)
  54. 【形式３】Jasmine(JChange,テキスト,検索文字列,置き換え文字列)
  55. 【形式４】Jasmine(JReplace,テキスト,検索文字列,置き換え文字列)
  56. 【解説】
  57.   テキストに与えた文字列中の、先頭から検索して最初に現れた検索文字列を、置き換え文字列と置き換えます。検索文字列と置き換え文字列の長さが異なっていても構いません。最初に現れた文字列を置換するだけなので、テキスト中の全ての検索文字列を置き換える場合は、repeat構文等を用いて繰り返し本機能を実行する必要があります。形式１〜４までの違いは、「J」系統が日本語文字区切りを用います。「change」系統は、検索時にアルファベットの大／小文字を厳密に区別します。
  58.  
  59. −文字数を数える
  60. 【形式】Jasmine(Chars,テキスト)
  61. 【解説】
  62.   テキストに与えた文字列の文字数を返します。２バイトコードは１文字として数えます。文字列のバイト数を数えたいときは、HyperTalkのlength関数を使用してください。
  63.  
  64. −文字列中から指定文字列を探し出し、その位置を返す
  65. 【形式１】Jasmine(find,テキスト,検索文字列)
  66. 【形式２】Jasmine(search,テキスト,検索文字列)
  67. 【形式３】Jasmine(jfind,テキスト,検索文字列)
  68. 【形式４】Jasmine(jsearch,テキスト,検索文字列)
  69. 【解説】
  70.   テキストに与えた文字列中から、検索文字列を探し出してその位置を返します。見つからなかった場合は０を返します。形式１〜４間での違いは、「J」系統が日本語文字区切りを採用し、文字単位で位置を返します。形式１、２の方は、バイト単位で位置を返します。「search」系統は、検索時にアルファベットの大／小文字を厳密に区別します。
  71.  
  72. −文字列中から指定文字列を探し出し、その行位置を返す
  73. 【形式１】Jasmine(lfind,テキスト,検索文字列)
  74. 【形式２】Jasmine(lsearch,テキスト,検索文字列)
  75. 【形式３】Jasmine(ljfind,テキスト,検索文字列)
  76. 【形式４】Jasmine(ljsearch,テキスト,検索文字列)
  77. 【解説】
  78.   テキストに与えた文字列中から、検索文字列を探し出してそれが何行目かを返します。見つからなかった場合は０を返します。形式１〜４間での違いは、「J」系統が日本語文字区切りを採用し、文字単位で位置を返します。形式１、２の方は、バイト単位で位置を返します。「search」系統は、検索時にアルファベットの大／小文字を厳密に区別します。つまり、前掲の「文字列中から指定文字列を探し出し、その位置を返す」の４つの形式と同じです。違いは文字やバイト数で位置を返すのではなく、行で返すということだけです。
  79.  
  80. −アルファベットを大文字／小文字に統一する
  81. 【形式１】Jasmine(toUpper,テキスト)
  82. 【形式２】Jasmine(toLower,テキスト)
  83. 【解説】
  84.   テキストに与えた文字列中のアルファベットを、大文字（形式１）あるいは小文字（形式２）に統一します。テキスト中の日本語文字列には影響しません。
  85.  
  86. −文字列中から指定範囲を抜き出す
  87. 【形式１】Jasmine(pick,テキスト,開始バイト位置,取り出すバイト数)
  88. 【形式２】Jasmine(jpick,テキスト,開始文字位置,取り出す文字数)
  89. 【形式３】Jasmine(take,テキスト,開始バイト位置,取り出すバイト数)
  90. 【解説】
  91.   テキストに与えられた文字列中から、指定範囲を取り出して返します。開始位置は、テキスト先頭を１とします（HyperTalkによる文字列の扱いと同じ）。形式２の場合、２バイトコードを１文字として数えます。形式３では、取り出した結果の最終バイトが日本語文字（すなわち２バイトコード）の１バイト目の場合に限り、最終バイトを削除します。
  92.   テキストの終端を越えた範囲指定が行われた場合、開始位置からテキストの終わりまでの文字列が返されます。開始位置がテキストの終端を越えていた場合は、空文字列が返されます。
  93.  
  94. −２つの文字列の比較
  95. 【形式１】Jasmine(Compare,テキスト,テキスト２)
  96. 【形式２】Jasmine(match,テキスト,テキスト２)
  97. 【解説】
  98.   テキストとテキスト２に与えた文字列を比較し、一致した場合にtrueを返します。形式１の場合は、比較時にアルファベットの大／小文字を厳密に区別します。
  99.  
  100.   ここまでの使用でJasmine呼び出し時に返される可能性のあるエラーメッセージは以下の通りです。エラーが起きた場合は、以下のリストの通り、先頭に「Error:」が付加されています。
  101.  
  102.   Error:Unknown command!  （理解できないコマンドが指定された）
  103.   Error:Memory allocate failed!  （メモリーが確保できなかった）
  104.   Error:Work memory allocate failed!  （メモリーが確保できなかった）
  105.   Error:Return memory allocate failed!  （メモリーが確保できなかった）
  106.   Error:Missing parameters  （パラメーターが無い）
  107.   Error:Parameter structure invalid!  （パラメーターの構成に誤りがある）
  108.   Error:Operation text missing!  （操作対象のテキストが与えられなかった※emptyを与えた場合は除く）
  109.   Error:Search string is empty!  （検索用の文字列が与えられなかった※emptyを与えた場合は除く）
  110.  
  111.     ※Jasmineは、長さの異なる文字列の置換や、アルファベットの大小比較を無視する場合に、内部的に大量のメモリー（テキストの長さの２〜３倍）を必要とする場合があります。大きなテキストを定常的に扱う場合は、HyperCardへの割当メモリーを増やしてください。
  112.  
  113. 8．XCMDバージョン
  114.  
  115.   以下の方法で、Jasmineのバージョンを調べることができます。
  116.  
  117.     Jasmine(XCMDVersion)
  118.  
  119.   the resultによって以下の書式のメッセージが取り出せます。
  120.  
  121.     Jasmine XFCN Version *.** by -Chai-
  122.     Jasmine XFCN PPCVersion *.** by -Chai-      （Power Macintoshバージョンの場合）
  123.  
  124.   ４ワード目(*.**と表わしたところ）に必ずバージョンナンバーが格納されているので、チェックする場合はそれを対象にしてください。
  125.  
  126. 9．Jasmineの使用上の注意
  127.  
  128.  JText XFCN 1994 (C) Copyright ちゃい=Chai=
  129.  Jasmine XFCN 1996 (C) Copyright 落合  徹（ちゃい）
  130.  
  131.   当パッケージを使用してトラブルが起こった際に、本項を読んでいないといった理由は一切受け付けることはできません。内容主旨を理解したうえでご使用ください。
  132.  
  133.   再配付を行なう様な場合は許可を取ってください（店頭での配付や、他ネットでの配付も含む。有料・無料どちらの場合もお願いします）。
  134.   個人的使用、およびそれに準ずる範囲内を越えた利用の際は、次項の注意をよく理解した上で使用してください。
  135.  
  136.   当パッケージを使ったことによって生じた直接、間接の損害については、権利者および配付者は一切の責を負わないこととします。あくまで使用者の責任の範囲で運用を行なってください。
  137.  
  138. 10．XCMD/XFCNの使用上の注意
  139.  
  140.   当XCMD/XFCNの著作権その他の権利は落合  徹（ちゃい）が所有しています。無断で外部使用することを禁じます。この項の説明はstart usingなどで間接的にXCMD/XFCNを使用する場合（Citronでの利用）も、同じ扱いとします。
  141.  
  142.   Citronの登録ユーザーの方は、個人的使用、およびそれに準ずる範囲内で、自由にご使用ください。
  143.   PDSその他等で配付する場合は以下の通りとなります。いずれの場合も、配布者はCitronの登録ユーザーである必要があります。
  144.  
  145.   ･フリーウエアに収録して配付の場合は、XCMD使用料(配付ソフト一種につき￥１０００)をいただきます。
  146.   ･シェアウエアもしくはそれに準ずる形式の配付の場合は（あるいはフリーウエアでも有償にて配付する場合）、XCMD使用料(配付ソフト一種につき￥５０００)をいただきます。
  147.   ･業務目的で使用する場合、利益を生む配付（市販も含む）を行なう場合は別途ご相談ください。XCMD使用料およびライセンス料をいただきます。
  148.  ・収録せずに利用する場合、すなわちstart using等でCitronに収録されたXCMD/XFCNを呼び出す場合は、上３項目に該当しません（つまり、無料ですし、連絡の必要もありません。配布者がCitronの登録ユーザーである必要はあります）。ただし、当然ながらXCMD/XFCNを使用するソフト（配布ソフト）のユーザーがCitronの登録ユーザーである必要があります。
  149.  ・当XCMD/XFCNを収録したフリーウエア／シェアウエア（もしくはこれらに準ずる形式の配布形態）を雑誌等の媒体にて配布する場合、シェアウエアもしくはそれに準ずる形式の配付とみなして、配布ソフト作成者あるいは配布者（雑誌等の媒体）より、XCMD使用料(配付ソフト一種につき￥５０００)をいただきます。ただし、シェアウエアもしくはそれに準ずる形式の配付として既にXCMD使用料をいただいている場合は、二重に支払う必要はありません。
  150.  
  151.   連絡を取る場合は、２日〜１ヵ月の余裕をみておいてください。
  152.   無断使用が発覚した場合、賠償請求させていただくことがあります。
  153.  
  154.   どの場合もドキュメント等に、以下の項目を記載してください。
  155.   文章スタイル等は変更なさってもかまいません。
  156.  
  157. ・Jasmine XFCNの著作権その他の権利は落合  徹（ちゃい）（Nifty:QGA01617）が所有しています。
  158. ・Jasmine XFCNを自作スタック等に使用なさりたい場合は、Nifty-Serve FMACHYPよりCitronスタックを入手し、登録した上でご利用ください。
  159. ・Jasmine XFCNを使ったことによって生じた直接、間接の損害については、XCMD作者および配付者は一切の責を負わないこととします。あくまで使用者の責任の範囲で運用を行なってください。
  160. ・無断使用が発覚した場合、賠償請求させていただくことがあります。
  161.  
  162. 動作チェック環境
  163.   漢字Talk 7.5.3
  164.   HyperCard 2.3J
  165.   QuickTime 2.5E
  166.   Power Macintosh 8100/80AV,Macintosh LC630,Power Macintosh PowerBook 5300cs
  167.  
  168.   漢字Talk７以降なら、動作するものと思われます。
  169.